package com.qiongqi.datadir.service;

public interface IPdfViewerService {

    /**
     * 获取受保护的 PDF 页面图像（带水印）
     * @param bucketName 资源桶名
     * @param objectName 资源对象名
     * @param page 页码（从 1 开始）
     * @param token 访问令牌
     * @param username 用户名
     * @param ip 用户 IP
     * @return 图像字节数组（JPEG）
     */
    byte[] renderSecuredPage(String bucketName, String objectName, int page, String token, String username, String ip)
            throws Exception;

    /**
     * 生成受保护的访问 Token
     * @param bucketName 资源桶名
     * @param objectName 资源对象名
     * @param username 用户名
     * @param ip 用户 IP
     * @return token
     */
    String generateSecureToken(String bucketName, String objectName, String username, String ip);
}
